Send data to the server.

Syntax

Visual Basic (Declaration)
<DescriptionAttribute("Send data from your buffer.")> Public Overloads Function Send( _ ByVal buffer() As Byte _ ) As Segment

Visual Basic (Usage)	Copy Code
Dim instance As Tcp Dim buffer() As Byte Dim value As Segment value = instance.Send(buffer)

C#
[DescriptionAttribute("Send data from your buffer.")] public Segment Send( byte[] buffer )

Managed Extensions for C++
[DescriptionAttribute("Send data from your buffer.")] public: Segment* Send( byte[]* buffer )

C++/CLI
[DescriptionAttribute("Send data from your buffer.")] public: Segment^ Send( array<byte>^ buffer )

Parameters

buffer: Source memory location for the data to send.

Return Value

A Segment object encapsulating information about the data sent.

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	offset or count is less than 0.
System.ArgumentException	offset + count is greater than the length of buffer.
System.Net.Sockets.SocketException	The socket is not connected.

Example

The following example demonstrates sending bytes to the server.

Visual Basic	Copy Code
Private Sub Test() ' Connect to an echo port Tcp1.Connect("atropos", 7) Dim sendbuffer() As Byte = System.Text.Encoding.Default.GetBytes("abcdefg") ' Send some bytes. Tcp1.Send(sendbuffer) Dim recvbuffer(sendbuffer.Length) As Byte ' Server will echo the bytes back. Receive the bytes. Tcp1.Receive(recvbuffer) ' Close the connection. Tcp1.Close() End Sub

Visual Basic

Copy Code

Private Sub Test()
   ' Connect to an echo port
   Tcp1.Connect("atropos", 7)

   Dim sendbuffer() As Byte = System.Text.Encoding.Default.GetBytes("abcdefg")

   ' Send some bytes.
   Tcp1.Send(sendbuffer)

   Dim recvbuffer(sendbuffer.Length) As Byte

   ' Server will echo the bytes back. Receive the bytes.
   Tcp1.Receive(recvbuffer)

   ' Close the connection.
   Tcp1.Close()
End Sub

C#	Copy Code
private void Test() { // Connect to the echo port tcp1.Connect("atropos", 7); byte[] sendbuffer = System.Text.Encoding.Default.GetBytes("abcdefg"); // Send some bytes. tcp1.Send(sendbuffer); byte[] recvbuffer = new byte[sendbuffer.Length]; // Server will echo the bytes back. Receive the bytes. tcp1.Receive(recvbuffer); // Close the connection. tcp1.Close(); }

Copy Code

private void Test()
{
   // Connect to the echo port
   tcp1.Connect("atropos", 7);

   byte[] sendbuffer = System.Text.Encoding.Default.GetBytes("abcdefg");

   // Send some bytes.
   tcp1.Send(sendbuffer);

   byte[] recvbuffer = new byte[sendbuffer.Length];

   // Server will echo the bytes back. Receive the bytes.
   tcp1.Receive(recvbuffer);

   // Close the connection.
   tcp1.Close();
}

Remarks

After connecting, data can be received using the Tcp.Send method. All Tcp.Send methods return a Segment object, encapsulating information about the data sent such as the data sent, and the amount of bytes of data sent.

This method is functionally equivalent to Tcp.Stream.Write(byte[]).

Requirements

Target Platforms: Microsoft .NET Framework 2.0